home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / os2 / xl2270.zip / XLIST.DOC < prev    next >
Text File  |  1992-06-03  |  53KB  |  1,307 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                                           XLIST
  22.  
  23.                                           DISK MANAGER
  24.  
  25.                                           USERS GUIDE
  26.  
  27.                                           for the
  28.  
  29.                                           MS-DOS & OS/2
  30.  
  31.  
  32.  
  33.                                           by
  34.  
  35.                                           GARY W. WOOD
  36.  
  37.  
  38.                    *** READ CAREFULLY BEFORE USING XLIST ***
  39.                            PROGRAM LICENSE AGREEMENT
  40.  
  41. Xlist (tm) is NOT "Public Domain" and it is NOT "Freeware".  Xlist is
  42. a copyrighted software product developed and owned by Gary W. Wood.
  43. Xlist is distributed under the shareware concept.  You are free to
  44. copy and use the software for personal use and shareware
  45. distribution in its original, unmodified form provided no fee
  46. beyond reasonable media and/or shipping charges is levied.
  47.  
  48. If you are using the software for personal use, your required to
  49. license the software after a 21 day evaluation period for $25 and
  50. become a Xlist supporter.  Xlist supporters will receive the next
  51. major release free of charge and be keep informed of major
  52. developments for one (1) year.  A license is required for use of
  53. Xlist by corporations and institutions, and for its commercial
  54. distribution.  You may obtain a license for the use of Xlist by
  55. writing to me.  The license is for perpetual, non-exclusive use of
  56. any version.  Purchase orders and invoicing are acceptable.  If you
  57. have special requirements, such as licensing for an unlimited
  58. number of copies, local area networks, site licenses, or
  59. customization, please feel free to submit them in writing.  You may
  60. request a license for:
  61.  
  62.       o     an unlimited number of end user copies at a single site;
  63.       o     customization of messages and documentation,  an
  64.             additional fee may be required depending on the extent of
  65.             changes;
  66.       o     permission to distribute within your organization;
  67.       o     permission to include with your company's commercial
  68.             products;
  69.  
  70. The fee for a license depends on the estimated number of copies of
  71. the program that you will use.  If you wish to distribute Xlist
  72. with your own programs or hardware, write for a "Marketing
  73. License".  To use the discount schedule below, estimate the total
  74. number of copies that you may eventually use.
  75.  
  76.      2 to  9 computers ..... at $20 each
  77.     10 to 24 computers ..... at $16 each
  78.     25 to 49 computers ..... at $13 each
  79.     50 to 99 computers ..... at $10 each
  80.     100 or more computers .. $1000 one time fee
  81.  
  82. Regardless of the quantity, only one set of materials will be sent
  83. to you.  You may then make as many copies of it that are licensed.
  84. Maintenance is free.  Upgrades will be made available upon request.
  85. Technical support is available via mail, or through the Compuserve
  86. bulletin board systems (76156,317), at no charge.
  87.  
  88.                      Copyright (C) 1985-1992 Gary W. Wood
  89.  
  90.  
  91.  
  92.  
  93. If you use Xlist after the 21 day evaluation period a license fee
  94. of $25 will register you to receive a current version of Xlist.
  95. Please state the current version of Xlist that you have.  Send
  96. contributions to:
  97.  
  98.             Gary Wood
  99.             5401 Lakeview Road
  100.             North Little Rock, Arkansas  72116
  101.  
  102. All rights reserved.  Printed in the United States of America.  No
  103. part of this publication may be reproduced, stored in a retrieval
  104. system, or transmitted in any form or by any means, electronic,
  105. mechanical, photocopying, recording, or otherwise without the prior
  106. written permission from Gary W. Wood, 5401 Lakeview Road, North
  107. Little Rock, Arkansas, 72116.
  108.  
  109.  
  110.  
  111.  
  112.                                   DISCLAIMER
  113.  
  114. The author has taken due care in the preparation of this document
  115. and the associated program.  Insofar as specific mention of program
  116. features, the author believes the information to be true.  No
  117. warranty is made regarding the suitability of the program to be
  118. compatible with your computer.  Incidental and consequential
  119. damages caused by malfunction, defect, or otherwise are not the
  120. responsibility of Gary W. Wood, and to the extent permitted by law,
  121. and hereby excluded both for the property and, to the extent not
  122. unconscionable, for personal injury damage. (Some states or
  123. jurisdictions do not allow the exclusion or limitation of
  124. incidental or consequential damages, so the above limitation or
  125. exclusion may not apply to you.)  Gary W. Wood also reserves the
  126. right to make amendments to the contents of this document from time
  127. to time, to reflect changes made to the specification of the Xlist
  128. system or for any other reason.
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137. Xlist is a Trademark of Gary W. Wood.  IBM, IBM-PC, PC-XT, PC-AT,
  138. PS/2, DOS, OS/2, VM/CMS, FLIST, and PC-DOS are Trademarks of
  139. International Business Machines Corp. MS-DOS is a Trademark of
  140. Microsoft Corporation. CHAPTERS
  141.  
  142.  
  143.  
  144. 1.    Introduction                                                5
  145.  
  146. 2.    Getting Started                                             6
  147.  
  148. 3.    Invoking the Xlist Command                                  8
  149.  
  150. 4.    Using the Keyboard                                          9
  151.  
  152. 5.    Increasing background performance (OS/2)                    10
  153.  
  154. 6.    Mouse Support                                               11
  155.  
  156. 7.    Tagging Files                                               12
  157.  
  158. 8.    Use of the Xlist.CNF File                                   14
  159.  
  160. 9.    Maintaining the Xlist.PRO Profile                           15
  161.  
  162. 10.   Command Line Commands                                       26
  163. INTRODUCTION
  164.  
  165.  
  166.  
  167. WELCOME TO THE WORLD OF DISK MANAGEMENT USING
  168. Xlist - DISK UTILITY
  169.  
  170.       If you are new to PC-DOS, you have realized that commands
  171.       provided by PC-DOS are designed to be short and sweet.  This
  172.       program is designed as a tool to effectively provide the user
  173.       a friendly way to view files contained in sub-directories and
  174.       be able to execute programs and PC-DOS commands.
  175.  
  176.       Xlist was written in 1985 modelled after IBM's VM/CMS mini-
  177.       disk manager called FLIST.  FLIST is a full-screen utility
  178.       that runs under CMS that allows professional programmers using
  179.       IBM 370 architecture VM machines to view a structured list of
  180.       available files and launch applications and commands by just
  181.       entering the command next to the corresponding file.
  182.  
  183.       Xlist provides a greatly enhanced version of FLIST providing
  184.       a powerful platform for executing MS-DOS commands, hard disk
  185.       management and launching applications.  Much time has been
  186.       used to make sure Xlist respects the current video mode and
  187.       tries to provide a natural feel that is easy to master.
  188.  
  189.  
  190. GETTING STARTED
  191.  
  192.  
  193.  
  194. WHAT KIND OF HARDWARE & SOFTWARE DO I NEED?
  195.  
  196.  
  197.       To use Xlist you need the following:
  198.  
  199.       An IBM-PC with hard disk, PC-AT, PS/2, or a very closely
  200.       compatible microcomputer.
  201.  
  202.       A color/graphics adapter, monochrome adapter, EGA, or VGA
  203.       adapter
  204.  
  205.       640K of RAM memory for best results.  The program requires at
  206.       least 135K of memory.
  207.  
  208.       One diskette drive
  209.  
  210.       DOS 2.1+ or OS/2 1.2+  (Note: OS/2 1.0 version available on
  211.       request.)
  212.  
  213.       Will use EMS memory when available
  214.  
  215. WHAT DO I DO NOW
  216.  
  217.  
  218.       Installing Xlist to operate on your system is a simple
  219.       process.  You should start by copying the distribution
  220.       diskette and putting the original away in a safe place.
  221.  
  222.       Now, copy the files on the diskette or unarchive the
  223.       application to a directory on your hard disk searched by the
  224.       DOS PATH.  The PC-DOS "PATH" command specifies a directory
  225.       search order for commands and/or batch files that are not in
  226.       the current drive/directory.
  227.  
  228.       For best performance of Xlist when utilizing the capability to
  229.       page Xlist to a temporary file, set the following environment
  230.       parameter.
  231.  
  232.       (See the *OVERLAY option in Chapter 7 for more information.)
  233.  
  234.       SET TMP=D:\         <--- Point to RAM disk.
  235.  
  236.       You are now ready!
  237. INVOKING THE Xlist COMMAND
  238.  
  239.  
  240. WHAT ARE THE INVOKING PARAMETERS?
  241.  
  242.  
  243.       First, no parameters are mandatory, but under some conditions
  244.       you may want to specify them to limit or expand the directory
  245.       entries displayed.
  246.  
  247.       To invoke the program enter:
  248.  
  249.             Xlist [[d:][path][filename[.ext]] /L /A
  250.  
  251.       The optional parameters have the following definitions:
  252.  
  253.             [[d:][path][filename[.ext]] to specify the file and/or
  254.             files that will be initially be displayed by the Xlist
  255.             screen.
  256.  
  257.             [/L] is used to tell Xlist to display license
  258.             information.
  259.  
  260.             [/A] will instruct Xlist to display every file on the
  261.             drive.
  262.  
  263.             [/*] is used to provide override "Xlist.PRO" profile
  264. commands.
  265.  
  266.  
  267.       Examples:
  268.  
  269.       Execute Xlist loading the directory from the default drive
  270.       directory and the root directory of the C: drive.
  271.  
  272.       Xlist *.*   c:\*.*
  273.  
  274.       Activate the performance options for Xlist OS/2 to wait 10
  275.       seconds before going into idle mode.
  276.  
  277.       Xlist /*KEYWAIT=10      /*SLEEP=1000
  278.  
  279.       Execute Xlist and redefine hotkey to press alt & right shift
  280.       key and disable the mouse functions.
  281.  
  282.       Xlist /*hotkey=alt=rightshift       /*mouse=off USING THE KEYBOARD
  283.  
  284.  
  285. WHAT KEYS ON THE KEYBOARD DOES Xlist USE?
  286.  
  287.       Xlist uses the keyboard for communicating instructions from
  288.       you to Xlist.  The keyboard is used to enter commands, scroll
  289.       the display, and to invoke user-defined function keys.  These
  290.       are the keystroke commands used by Xlist.
  291.  
  292.       You may change command keys by using the "Alt-k" key.
  293.  
  294.       Defaults are defined as follows:
  295.  
  296.       Keystroke         Definition
  297.       Home              Position the cursor to the first character or entry.
  298.       End               Position the cursor to the last character or entry.
  299.       Ctrl-End          Erase data in the command line from the cursor
  300.                         to the end-of-line.
  301.       Alt-a             Change file attributes.
  302.       Alt-c             Change screen colors.
  303.       Alt-e             EGA/VGA video mode toggle switch.
  304.       Alt-f             Toggle to set Xlist to flush unexecuted
  305.                         commands when an error or CNTL-BREAK is
  306.                         encountered.
  307.       Alt-k             Change keyboard definitions.
  308.       Alt-s             Toggle between displaying filesize in K's
  309.                         or in total number of bytes.
  310.       Alt-t             Tag multiple files.
  311.       Alt-x             Exclude entry.
  312.       Esc               Exit Xlist.
  313.       Enter             Pass control to Xlist to process the command lines.
  314.       Ctrl-PgUp         Goto top of directory.
  315.       Ctrl-PgDn         Goto bottom of directory.
  316.       PgUp              Scroll up one screen.
  317.       PgDn              Scroll down one screen.
  318.       Shift-Shift       Popup the menu.
  319.       `                 Tag single entry toggle. (Key above TAB to left
  320.                         of "1")
  321. INCREASING BACKGROUND PERFORMANCE
  322.  
  323.  
  324.       When you use Xlist for OS/2 in the foreground and have another
  325.       application running in the background, OS/2 scheduling
  326.       conventions give the majority of the processing power to the
  327.       foreground application.  This can sometimes cause a dramatic
  328.       decrease in background processing performance.  Xlist of OS/2
  329.       avoids this possible decrease in performance by providing two
  330.       profile options that let you enhance your background
  331.       processing speed.  These profile commands are: *KEYWAIT and
  332.       *SLEEP.
  333.  
  334.       Why is there sometimes a decrease in background performance?
  335.       Xlist for OS/2 must continuously check for mouse movements and
  336.       keyboard shift status.  This is necessary for Xlist to display
  337.       shifted function key definitions and to sense mouse movements.
  338.       Because Xlist is always trying to gather this information, the
  339.       program is never really "idle" even when it appears to be.
  340.  
  341.  
  342. HOW THE PERFORMANCE OPTIONS WORK
  343.  
  344.  
  345.       When you use the *KEYWAIT and *SLEEP options, Xlist for OS/2
  346.       operates as explained in the example below.
  347.  
  348.       Example:
  349.  
  350.       You are running Xlist in the foreground, another application
  351.       in the background, and you're using the defaults for the
  352.       *KEYWAIT (5 seconds) and *SLEEP (1000 milliseconds).  When
  353.       using Xlist, if you do not make an entry for 15 seconds, Xlist
  354.       will become idle for 1/10 of a seconds (100 milliseconds).
  355.       When Xlist is idle, the background application is given
  356.       increased processing power resulting in an improved processing
  357.       speed.  At the end of the idle time Xlist checks for user
  358.       input.  If none is found, Xlist goes back into idle mode for
  359.       another 1/10 of a second.  Xlist continues the idle/check loop
  360.       until it detects user input.
  361.  
  362.       How does Xlist idle time affect you?  When Xlist is idle the
  363.       response to you input is delayed by the number of milliseconds
  364.       specified.  This means that your first couple of keystrokes
  365.       will not appear on the screen for a fraction of a second.
  366.       However, after you begin typing, Xlist comes out of the idle
  367.       mode and normal typing speed is resumed. MOUSE SUPPORT
  368.  
  369.  
  370. HOW DOES THE MOUSE INTERFACE WITH Xlist?
  371.  
  372.  
  373.  
  374.       Xlist will use a mouse device when available.  The mouse is
  375.       capable of scrolling the screen, executing function keys,
  376.       moving between directories, tagging & untagging entries, and
  377.       bring up a series of menus.  A mouse will have anywhere from
  378.       2 to 3 buttons.  For the purpose of this discussion, we will
  379.       call the buttons the left, center and right buttons.
  380.  
  381.       Scrolling: You may scroll the display by positioning the mouse
  382.       pointer to the top or bottom right most position and pressing
  383.       either the right or left button.  The left button will scroll
  384.       a full screen while the right button will scroll continuously
  385.       one entry at a time.
  386.  
  387.       Function Key: Position the mouse pointer over the function key
  388.       definition on the last row of the display and press the left
  389.       button.
  390.  
  391.       Directories: Position the mouse pointer on the first row and
  392.       press the right button to move from the current directory to
  393.       the directories parent.  Position the mouse pointer to a
  394.       directory entry on the main screen area and double click the
  395.       left button to move to the corresponding directory.
  396.  
  397.       Tagging: Position the mouse pointer to the first entry to tag
  398.       and press the center button or both the left and right buttons
  399.       at the same time an drag the mouse pointer to tag multiple
  400.       entries.  Use the right button to untag already tagged
  401.       entries.
  402.  
  403.       Menus: Position the mouse pointer to the first row and click
  404.       the left button.
  405.  
  406. TAGGING FILES
  407.  
  408.  
  409.  
  410.       When using Xlist you normally view the directory structure and
  411.       process a series of MS-DOS commands against corresponding
  412.       directory entries.  This is normally executed by positioning
  413.       the highlighted line with the cursor keys to the directory
  414.       entry and entering a MS-DOS command beside the entry.
  415.  
  416.       If you would like to perform the same command to a series of
  417.       files you should navigate from page to page and tag files you
  418.       would like to execute the same command using the designated
  419.       "tag" key or using the alt-t command to globally tag multiple
  420.       files.
  421.  
  422.       After pressing the <ENTER> key, Xlist will process commands
  423.       starting with the first command located adjacent to a
  424.       directory entry.  Subsequent tagged entries will have that
  425.       command processed against that entry as if you had entered the
  426.       command over and over adjacent to each tagged directory entry.
  427.  
  428.  
  429.        LVL 1 - C:\                   (   8K) 158,447  PAGE 1 OF 15
  430.       DELETE                        <DIR>     12-17-91   7:20p ....
  431.       NOWHERE                       <DIR>     12-17-91   7:21p ....
  432.       OS2                           <DIR>     12-17-91   6:49p ....
  433.       ANIMATE  EXE  erase               19152 05-07-90   9:18p A...
  434.       ASTEROID EXE                      23936 06-22-90  11:47a A...
  435.       AUTOEXEC BAT  copy / a:            1048 12-22-91   3:58p ....
  436.       CONFIG   SYS                        417 12-22-91   8:11p ....
  437.       DASDDRVR SYS                       1170 03-02-90  12:00p ....
  438.       IMAGE    BAK  /a-r~erase          50688 12-23-91   8:21p .R..
  439.       KTCCACHE EXE                       3344 04-11-91  12:02p A...
  440.       OS2LDR   MSG                       7928 10-09-91   2:20p ....
  441.       SPOOL         cd              <DIR>     12-17-91   7:21p ....
  442.       STARTUP  CMD                         76 12-22-91   4:32p ....
  443.       IMAGE    DAT                      50688 12-23-91   8:21p ....
  444.  
  445.       In the example specified above we have tagged entries from ANIMATE.EXE
  446.       through KTCCACHE.EXE using the "tag" key causing Xlist to highlight the
  447.       tagged lines.  Then, we positioned the cursor to "ANIMATE.EXE" and entered
  448.       "erase", skipped to "AUTOEXEC.BAT" and entered "copy / a:", skipped to
  449.       "IMAGE.BAK", entered "/a-r~erase" and changed directory to C:\SPOOL.
  450.       What happens???
  451.  
  452.       Xlist will execute the MS-DOS "erase" command following by "ANIMATE.EXE"
  453.       causing the file to be deleted by MS-DOS...because the following line is
  454.       also tagged, Xlist will erase "ASTEROID.EXE"...the command is changed to
  455.       "copy / a:" causing Xlist to execute "copy AUTOEXEC.BAT a:"...then "copy
  456.       CONFIG.SYS a:"...then "copy DASDDRVR.SYS a:"...the command is changed to
  457.       "/a-r~erase" causing Xlist to remove the read-only file attribute and
  458.       erase "IMAGE.BAK"...then will erase the last tagged file
  459.       "KTCCACHE.EXE"...then will change directory to C:\SPOOL.
  460.  
  461.       You should note that the "~" character is used for logical command end
  462.       used to stack commands and the "/a-r" is an internal Xlist command used
  463.       to change file attributes.  You will see discussions of these commands
  464.       later within the documentation.
  465. USE OF THE Xlist.CNF FILE
  466.  
  467.  
  468. WHAT PARAMETERS ARE IN THE CONFIGURATION FILE?
  469.  
  470.  
  471.       The 'Xlist.CNF' file contains the initial keyboard and color settings.  You
  472.       may modify these using the "Alt-c" for color changes and the "Alt-k" for
  473.       keyboard changes.  If by some chance this file is corrupted, erase the
  474.       file and Xlist will recreate it to it's default values.  This file is
  475.       maintained by Xlist and cannot be edited by a text editor.  If you corrupt
  476.       the keyboard or color settings, Xlist will recreate the file if you will
  477.       erase the file.  It will be recreate in the current drive/directory if
  478.       Xlist.EXE is located in the directory or in the first path specified by the
  479.       MS-DOS PATH command.
  480.  
  481. MAINTAINING THE Xlist.PRO PROFILE
  482.  
  483.  
  484. WHAT PARAMETERS ARE IN THE PROFILE?
  485.  
  486.  
  487.       The 'Xlist.PRO' file is used to communicate a multitude of parameters to
  488.       Xlist that allow it to be tailored to your individual needs.  Use a text
  489.       editor, such as BRIEF, KEDIT, or EDLIN to modify the profile parameters
  490.       based on the following parameter descriptions.  There is no way the
  491.       provided profile will suit your needs and you should modify at least the
  492.       *PFKEYS and *EXECUTE parameters.
  493.  
  494.       The profile is found by Xlist by first checking the default
  495.       drive/directory, then by following the paths set by the MS-DOS "PATH"
  496.       command.  All Xlist options are identified by preceding keyword that start
  497.       with an asterisk "*".  When the first character is not an asterisk the
  498.       command line is treated as a comment.
  499.  
  500.       Following is description of the parameters specified in the Xlist.PRO file.
  501.       Optional parameters are designated by separation using the "|" and
  502.       parameters that need a numeric value specified use "n" to designate a
  503.       numeric value.  The default value is the first parameter specified or
  504.       underlined.
  505. Xlist.PRO PROFILE PARAMETERS
  506.  
  507.  
  508. *ALLATTR    OFF | ON | DISABLE
  509.  
  510.       The *ALLATTR is used in conjunction with changing the attributes of a MS-
  511.       DOS directory using the /A command.
  512.  
  513.       OFF         Only files under the specific directory will be changed.
  514.       ON          All files under the sub-directory will be changed.
  515.       DISABLE     Will not function on sub-directories.
  516.  
  517.  
  518. *BUFSIZE    32767 | nnnnn
  519.  
  520.       Use the *BUFSIZE command to assign the size reserved for "Xlist" to use
  521.       as a "COPY" Input / Output buffer.  The buffer is allocated the first time
  522.       the "COPY" command is used.  The size may be decreased down to 512
  523.       characters.  By decreasing the buffer size, performance of the "COPY"
  524.       command will be impaired.
  525.  
  526.  
  527. *DIRATTR    n+r+d+a | n+r+h+s+v+d+a
  528.  
  529.       The *DIRATTR command is used to define what attribute is used to search
  530.       the DOS directory.  This is used to setup a mask used during the search
  531.       of the directory to select what entries are included when displaying
  532.       directory entries on the Xlist screen.
  533.  
  534.       The attribute byte is mapped as follows:
  535.  
  536.       Value                   Description
  537.         n               Normal file
  538.         r               Read-only file
  539.         h               Hidden file
  540.         s               System file
  541.        *v               Volume label
  542.         d               Directory
  543.         a               Archival file
  544.  
  545. * Volume is not available on OS/2 operating systems. *DISABLE    [command]
  546.  
  547.       Xlist will intercept some MS-DOS commands,  this gives greater control to
  548.       Xlist when monitoring the directory and keeps MS-DOS from writing over
  549.       Xlist's screen.  The MS-DOS "Copy" & "Rename" command executed by Xlist
  550.       are not fully compatible with MS-DOS's "Copy" & "Rename" in that Xlist
  551.       won't allow wild cards in the source parameter.  Also, note that Xlist will
  552.       get a up to a 32K buffer, this will increase the size of Xlist and this
  553.       space won't be given back.  If you wish to use wild cards, either disable
  554.       the command or use the "DOS" command to use MS-DOS.
  555.  
  556.       Profile parameter *DISABLE command is used to disable MS-DOS commands
  557.       that Xlist will intercept.  The following commands can be disabled:
  558.  
  559.             *DISABLE COPY
  560.             *DISABLE DEL
  561.             *DISABLE ERASE
  562.             *DISABLE RENAME
  563.             *DISABLE REN
  564.             *DISABLE CHDIR
  565.             *DISABLE CD
  566.             *DISABLE MKDIR
  567.             *DISABLE MD
  568.             *DISABLE RMDIR
  569.             *DISABLE RD
  570.             *DISABLE MOVE
  571.  
  572.       It is to your advantage not to disable the above commands unless they
  573.       fail to perform to your expectations.  By allowing Xlist to intercept these
  574.       commands, it is better able to keep the command line up to date as changes
  575.       are made to the current directory.
  576.  
  577.  
  578.  
  579. *EMS  ON | OFF
  580.  
  581.       Option used in conjunction with the *OVERLAY profile command to enable
  582.       or disable use of EMS memory.  Normally, this option should be left on
  583.       because use of EMS memory swapping is almost instantaneous.
  584. *ENTRIES    500 | nnn
  585.  
  586.       The *ENTRIES command is used to provide a method for the user to specify
  587.       how much memory is used by Xlist to hold directory entry information.
  588.       Each directory is held in memory by Xlist to be displayed on the screen.
  589.       The maximum number of entries Xlist can load is 2500.
  590.  
  591.       Whenever there are more entries than set by the *ENTRIES command, the
  592.       excess entries are bypassed.
  593.  
  594.  
  595. *EXECUTE          [pattern] [commands......]
  596. *EXECUTE-ARC      [pattern] [commands......]
  597. *EXECUTE-LZH      [pattern] [commands......]
  598. *EXECUTE-ZIP      [pattern] [commands......]
  599. *EXECUTE-ZOO      [pattern] [commands......]
  600.  
  601.       The *EXECUTE command is used to associate a series of commands to be
  602.       entered when the ENTER key is pressed.  This can be used to invoke a
  603.       browser, editor, Lotus 1-2-3, DBASEIII, or any other series of commands.
  604.  
  605.       You can set up multiple *EXECUTE commands within the Xlist.PRO profile.
  606.        They are scanned sequential each time the ENTER key is pressed to see
  607.       if any commands should be entered if the pattern matches the name of the
  608.       active file.
  609.  
  610.       Example:
  611.  
  612.       To have a program called "LIST" invoked whenever the ENTER key is
  613.       pressed for all files that start with either an A, B, or C and the extension
  614.       is "DOC".
  615.  
  616.       *EXECUTE [ABC]*.DOC LIST
  617.  
  618.       To execute the Wordperfect word processor when ENTER key is pressed
  619.       beside all files having the .WP5 extension.
  620.  
  621.       *EXECUTE *.WP5 WP
  622.  
  623.  
  624. *HOTKEY     RIGHTSHIFT  |  LEFTSHIFT  |  ALT  |  CONTROL
  625.  
  626.       The *HOTKEY command is used to redefine the menu keyboard hotkey
  627.       combination used to bring up the menus.  The default is by pressing both
  628.       shift keys at the same time.  You must specify two of the four possible
  629.       values.  The default is pressing both the shift keys at the same time.
  630.       This is the same combination as the IRMA's 3270 emulator and should be
  631.       changed in that instance.
  632.  
  633.       Example:
  634.  
  635.       To define the alt & control combination to envoke the menus.
  636.  
  637.       *HOTKEY     ALT  CONTROL
  638.  
  639.  
  640. *KEYWAIT    5 | nn
  641.  
  642.       The *KEYWAIT command is used to tell Xlist for OS/2 the number of seconds
  643.       to wait before going into idle mode.  Where nn is the number of seconds
  644.       (between 1 and 99) to wait.  The default is 5.  (See *SLEEP command)
  645.  
  646.  
  647. *LINEEND    ~ | c
  648.  
  649.       The *LINEEND command is used to define the logical line end character.
  650.       For entering multiple commands on the same line for execution.  The
  651.       default character is the '~'.  This character may be put on the command
  652.       line or used within the *PFKEYS or *EXECUTE profile commands.
  653.  
  654.  
  655. *LOGO       ON | OFF
  656.  
  657.       The *LOGO command is used to disable the presentation of the initial
  658.       copyright screen.  This presentation delays Xlist execution for 3
  659.       seconds.
  660. *MOUSE      ON | OFF
  661.  
  662.       The *MOUSE command is used to disable the interface to the mouse pointer.
  663.       This can be used to keep Xlist from continuously checking for mouse
  664.       movements.  Initialization of the Microsoft PS/2 mouse causes a noticable
  665.       startup delay.  This is normal for Microsoft's PS/2 mouse interface.
  666.  
  667.  
  668.  
  669. *OVERLAY    OFF | ON*
  670.  
  671.       The *OVERLAY command is used to maximize the amount of memory available
  672.       for commands invoked from within Xlist.  The option will default to ON
  673.       when at least 144K of EMS memory is available.  Xlist reduces the resident
  674.       portion of Xlist while another command is executed by temporarily
  675.       storing the Xlist program to a disk file.  After the invoked command is
  676.       finished, Xlist is read back in memory and execution resumes.  This will
  677.       effectively reduce the memory requirements of Xlist down to only 6K.  The
  678.       feature can be toggled on and off by using the "/s" option on the command
  679.       line.
  680.  
  681.       Xlist will free memory to a temporary work file or expanded memory.  Xlist
  682.       will swap to EMS(3.2+) memory to swap if available.  Otherwise, Xlist swaps
  683.       to a disk file up to 128K, and takes a long time to write out when the file
  684.       isn't on a RAM drive.  I suggest setting up a RAM drive in extended memory
  685.       using the VDISK.SYS device driver provided by MS-DOS or use EMS memory.
  686.  
  687.       Example:
  688.  
  689.       Change CONFIG.SYS to include the following:
  690.  
  691.       DEVICE=C:VDISK.SYS /e 196 512 64
  692.  
  693.       Change AUTOEXEC.BAT to include the following:
  694.  
  695.       SET TMP=D:\;C:\
  696.  
  697.       The path shown above would cause Xlist to try the ramdrive first, and if
  698.       it failed would try the C: drive next.
  699.  
  700. * *OVERLAY is not available on OS/2 operating systems. *PATHSZ     200 | nnn
  701.  
  702.       The *PATHSZ command is used to define the amount of memory reserved for
  703.       saving the DOS paths that have been previously been displayed during a
  704.       Xlist session.  This memory is automatically managed in conjunction with
  705.       use of the /BD command.
  706.  
  707. *PFKEYS           Xnn (btd) function
  708. *PFKEYS-ARC       Xnn (btd) function
  709. *PFKEYS-LZH       Xnn (btd) function
  710. *PFKEYS-ZIP       Xnn (btd) function
  711. *PFKEYS-ZOO       Xnn (btd) function
  712.  
  713.       This command provides the user with a method of defining the function
  714.       keys F1-F12 in order to execute commands using the function keys rather
  715.       than entering the command.  The function may be more than one command
  716.       each separated by the logical line end character (See *LINEEND for more
  717.       information). When viewing a ARC, LZH, ZOO or ZIP directory structure by
  718.       utilizing the /EXP, /ZIP, /LZH, /ZOO or /ARC commands, Xlist has the ability
  719.       to load another set of function key definitions.  These are specified by
  720.       appending "-ZIP", "-LZH", "ZOO" or "-ARC" upon the *PFKEYS keyword.
  721.  
  722.       The format for the command is as follows:
  723.  
  724.       *PFKEYS Xnn (btd) function
  725.  
  726.       X     = Shift key indicator.
  727.       blank = unshifted.
  728.       S     = right or left shift pressed.
  729.       C     = CTRL pressed.
  730.       A     = ALT pressed.
  731.       nn    = Function key number (1 through 12).
  732.       btd   = Abbreviation for display (optional).
  733.       function = Text inserted into Xlist command line.
  734.  
  735.       Examples:
  736.  
  737.       Set function key (F1) to compile a program using the Lattice C compiler.
  738.  
  739.       *PFKEYS 1 (lcs) lc -ms /c
  740.       Set function key (F2) to link-edit a program and cancel execution of Xlist.
  741.  
  742.       *PFKEYS 2 (lnk) link @xlistlk.lnk /o/c~/can
  743.  
  744.       Set function key (F3) to execute F1 & F2 commands.
  745.  
  746.       *PFKEYS 3 (all) /F1~/F2
  747.  
  748.       Set function key (F3) to un-zip active file using PKUNZIP to the
  749.       drive/directory specified by the TMP environment variable; execute a
  750.       program called "LIST" passing the name of the file as the first parameter;
  751.       erase the un-zipped file after execution of LIST.
  752.  
  753.       *PFKEYS-ZIP 3 (LIS) /cPKUNZIP -o $A %TMP% $F~LIST %TMP%$~ERASE %TMP%$
  754.  
  755.       Same as last example with LHA for a LZH archive entry with the TMPDRV
  756.       environment variable set to "D:" for a RAM drive.
  757.  
  758.       *PFKEYS-LZH 3 (LIS) /c%TMPDRV%~LHA -o $A %TMP% $F~LIST %TMP%$~ERASE
  759.       %TMP%$~/RESET
  760.  
  761.  
  762. *PFREF      OFF | ON
  763.  
  764.       The *PFREF command is used to tell Xlist to refresh the function key
  765.       definitions from the Xlist.PRO profile found in the current directory.
  766.       When Xlist senses that a drive or sub-directory change has occurred a
  767.       search is made in the current directory for the Xlist.PRO profile.  This
  768.       can be used to refresh the function key definitions between drives
  769.       and/or directories.
  770. *RETRACE    OFF | ON
  771.  
  772.       Profile parameter *RETRACE is used for IBM Personal Computers with IBM
  773.       Color/Graphics Monitor Adapters (CGA).  They require special programming
  774.       to prevent "snow" from appearing on the screen when a program changes
  775.       the contents of the screen buffer.  The required programming will slow
  776.       down screen updating and is not necessary for many other display
  777.       adapters.
  778.  
  779.       *RETRACE  ON
  780.  
  781.       Setting *RETRACE OFF on an IBM PC with an IBM color adapter will cause
  782.       "snow" on the screen in some instantaneous.
  783.  
  784.  
  785. *SLEEP      1000 | nnnnn
  786.  
  787.       This command controls idle mode.  It tells Xlist for OS/2 the number of
  788.       milliseconds to remain idle before checking for user input (keystrokes
  789.       or mouse movement).  Where nnnnn is the number of milliseconds (between
  790.       100 and 32000) to remain idle.  Any input cancels idle mode (after the
  791.       *SLEEP milliseconds expire).  The default is 1000.
  792.  
  793.  
  794. *SORT       [A | S | B | N | D | E | T][-]
  795.  
  796.       Profile parameter *SORT will cause Xlist to sort the directory before it
  797.       is displayed.  This will allow you to specify the order the entries are
  798.       arranged.
  799.  
  800.       The parameter definitions are:
  801.  
  802.             A     by attribute
  803.             S     by size
  804.             B     by blocksize (same as S)
  805.             N     by name
  806.             D     by date
  807.             E     by extension
  808.             T     by type (same as E, except sub-directories go to the top)
  809.  
  810.             -     descending order
  811. *TOPVIEW    OFF | ON
  812.  
  813.       The *TOPVIEW command is used to disable the access of the TOPVIEW video
  814.       buffer address.  Some video adapters have conflicts with the interrupts
  815.       used to access the TOPVIEW video buffer.  Setting this to the OFF setting
  816.       will make for faster screen access.
  817.  
  818.  
  819. *TREE       OFF | ON
  820.  
  821.       The *TREE command when set to "ON" will automatically load the directory
  822.       tree during startup of the Xlist program.  This will cause the startup of
  823.       Xlist to take a little longer.
  824.  
  825.  
  826. *TREEDATE   OFF | ON
  827.  
  828.       The *TREEDATE command is used to determine if the Xlist_x.LOG file
  829.       internal timestamp is to be used.  Xlist will create the file when scanning
  830.       directories.  The file is used when changing back to the drive in order to
  831.       save time.  You can instruct Xlist to use the file even if it was created
  832.       by a prior execution of Xlist by setting this option to the OFF position.
  833.       Xlist will execute faster, but, the directory tree may not reflect all
  834.       directories or show non-existent directories from previous executions
  835.       of Xlist.  You should reload the directory tree using the /RTREE command
  836.       when this occurs.
  837.  
  838.  
  839. *TREESCAN   OFF | ON
  840.  
  841.       The *TREESCAN command when set to "ON" will automatically preview files
  842.       within the directory.
  843.  
  844.  
  845. *VGAMODE    "Menu Title", "Font Filename"
  846.  
  847.       The *VGAMODE command is used in conjunction with EGA/VGA display
  848.       adapters that allows you to specify an optional character display table
  849.       (ie. FONT) to be loaded inplace of the resident fonts.  *VGAMODE commands
  850.       contain two pieces of information separated by a comma.  The first
  851.       parameter contains the heading contained in the menu within Xlist
  852.       corresponding to the specified FONT.  The heading must be contained
  853.       within double quotes, have two leading spaces and not exceed 40
  854.       characters in length.  The second parameter contains the MS-DOS file name
  855.       of the FONT.  This file is composed of 256 entrys between 8 to 14
  856.       characters in width.  These are the bitmaps for each possible character
  857.       from decimal 0 thru decimal 256.  You can create your own fonts by using
  858.       font editors that create normal MS-DOS character definition tables that
  859.       contain 256 entrys.
  860.  
  861.       If the *VGAMODE command isn't provided, Xlist will allow you to shift
  862.       between 25 line and 43 line modes using the alt-e keystoke or
  863.       corresponding menu commands.
  864.  
  865.       Some examples of font files are provided with Xlist which have the
  866.       extension of ".FNT".
  867. COMMAND LINE COMMANDS
  868.  
  869.  
  870. HOW TO USE THE COMMAND LINE
  871.  
  872.  
  873.       Xlist will present the directory vertically down the screen with a input
  874.       line next to each entry, this is the "COMMAND LINE".  The user can use the
  875.       cursor keys to navigate up and down the directory entering commands.
  876.       When the ENTER key is depressed, Xlist will process the commands from
  877.       top-to-bottom.  All commands entered are first examined by Xlist to find
  878.       special commands used by Xlist.  These commands are from logical line end
  879.       characters to special commands used to sort the directory into another
  880.       order.  Then Xlist will pass the commands to MS-DOS for execution.
  881.  
  882.       Based on a 80-column display, there are 33 characters that can be
  883.       presented to Xlist on the command line at any one time.  But, by continued
  884.       typing up to 63 characters can be entered.
  885.  
  886.       After the command is entered Xlist will append the filename and extension
  887.       name to the command unless told otherwise by the /o line command.
  888.  
  889.  
  890.       GENERAL NOTES:
  891.  
  892.       1.    Do not rename or erase files from a BAT file or with a "ERASE *.*"
  893.             sequence.
  894.  
  895.       These situations cannot be detected by Xlist and may result in random
  896.       displayed filenames or Xlist termination.  If you do the above, by
  897.       entering the "/RD" command, the directory is refreshed.
  898.  
  899. $       - SUBSTITUTE FILENAME & EXTENSION
  900.  
  901.       There are a series of characters using the '$' as a prefix that can be used
  902.       to imbed parameters into the command line automatically.
  903.  
  904.       /       -->  Substitute the DOS filename & extension.
  905.       //      -->  Will pass on one /.
  906.       $       -->  Substitute the DOS filename & extension.
  907.       $$      -->  Will pass on one $.
  908.       $P      -->  Substitute DOS pathname without trailing slash.
  909.       $N      -->  Substitute DOS filename without extension.
  910.       $E      -->  Substitute DOS extension.
  911.       $F      -->  Substitute DOS pathname, filename & extension.
  912.       $D      -->  Substitute DOS drive letter without trailing colon.
  913.  
  914.  
  915. /A      - CHANGE THE FILE ATTRIBUTES
  916.  
  917.       This command is used to modify the file attributes.  The attribute maybe
  918.       marked read-only, hidden, made a system file, or have the archive flag
  919.       turned on.
  920.  
  921.       When this is placed on a sub-directory, Xlist will change the attributes
  922.       of all the files within the directory. (See *ALLATTR profile command for
  923.       more information.)
  924.  
  925.       The format is:  /A[+/-][attribute]
  926.  
  927.       [+/-] the plus(+) is used to denote adding the attribute and the
  928.       negative(-) is used to remove an attribute.
  929.  
  930.       [attribute] is the one-character representation of the attribute to be
  931.       added or removed from the file.
  932.  
  933.             A  - Archive            R  - Read-only
  934.             H  - Hidden file        S  - System file
  935.             D  - Subdirectory
  936.  
  937. /AD     -  APPEND TO THE Xlist DIRECTORY
  938.  
  939.       The /AD command is used to append to the internal directory.  This can be
  940.       used to load additional entries from other drives or sub-directories.
  941.  
  942.       Examples:
  943.  
  944.       Set Xlist to only append the files with an extension of "EXE":
  945.  
  946.       /AD=*.EXE
  947.  
  948.       Append data from the root directory:
  949.  
  950.       /AD=C:\*.*
  951.  
  952.  
  953. /ARC    - EXPAND AN "ARC" FILE DIRECTORY
  954.  
  955.       Same function as the /EXP command for archive files with the ".ARC"
  956.       extension.  See the /EXP command for further details.
  957.  
  958.  
  959. /BD     - GO BACK TO PRIOR DIRECTORY
  960.  
  961.       This command is used to proceed back to previous sub-directory.
  962.       Whenever a sub-directory or drive change is made by entering the MS-DOS
  963.       CHDIR commands, Xlist will save the current directory in the path area
  964.       reserved by the *PATHSZ profile command.  By entering /BD the program
  965.       will automatically navigate back to the previous directory.
  966.  
  967.  
  968. /C      - CLEAR SCREEN BEFORE EXECUTING COMMAND
  969.  
  970.       When the /C is found in the command line it is extracted from the command
  971.       line and before the entered command is passed to the DOS command
  972.       processor the screen is cleared.  The video mode and character definition
  973.       table (font) is reset to MS-DOS's normal settings.  When a function key is
  974.       defined to invoke a program it is sometimes more appealing to have Xlist
  975.       clear the screen before invoking the program using the "/C" option.  This
  976.       also causes Xlist to clear and re-display the entire Xlist screen when
  977.       control is passed back from the program executed.
  978. /CAN    - CANCEL Xlist
  979.  
  980.       This command will exit Xlist and stay in the current directory and not
  981.       reset the video mode and character definition table (font) back to MS-
  982.       DOS's normal settings.
  983.  
  984.  
  985. /CLS    - CLEAR COMMAND LINE AREA
  986.  
  987.       This command will clear the Xlist command line area.
  988.  
  989.  
  990. DOS     - INVOKE SECONDARY COMMAND PROCESSOR
  991.  
  992.       Use the DOS command to pass control to the secondary DOS command
  993.       processor.  This command will load a copy of DOS and pass control to it.
  994.       You will remain in DOS until you return to Xlist by entering the EXIT
  995.       command.
  996.  
  997.       You should not execute any commands while in the secondary command
  998.       processor that will make them permanently resident.
  999.  
  1000.  
  1001. /DSPF   - DISPLAY USER-DEFINED FUNCTION KEYS
  1002.  
  1003.       You can use the /DSPF function to display the function keys currently
  1004.       defined.
  1005.  
  1006.  
  1007. /END    - END Xlist
  1008.  
  1009.       This command will exit Xlist and return to the drive and directory where
  1010.       Xlist was initially envoked.  This is the well-behaved ending of Xlist.
  1011.  
  1012. /EXE    - EXECUTE SPECIFIED PROGRAM
  1013.  
  1014.       The /EXE command is designed to be used in conjunction with the *EXECUTE
  1015.       profile command to specify the ".EXE", ".COM" and ".BAT" to be launched
  1016.       when the ENTER key is pressed next to the application executable
  1017.       program name.  This method presents a user-friendly window where you
  1018.       can specify additional parameters.
  1019. /EXP    - EXPAND AN "ARC", "LZH", "ZIP" or "ZOO" FILE DIRECTORY
  1020.  
  1021.       This command will read the directory contained within the specified
  1022.       archive file.  It will then display it using the Xlist directory display
  1023.       features.  Be aware that the /UD & /A sub-commands will be deactivated.
  1024.       To re-display the normal directory either press the ESC key or enter the
  1025.       /RD command.
  1026.  
  1027.       NOTE: You can use the /ZIP command to expand a ZIP file or /ARC to expand
  1028.       a ARC file or /LZH for LHA files.  The /EXP command determines whether it's
  1029.       a ZIP, LZH or ARC file from the file extension.
  1030.  
  1031.  
  1032. /F[x]nn  - EXECUTE FUNCTION KEY
  1033.  
  1034.       This command can be used to invoke function keys from the command line.
  1035.       As a matter of fact, when a function key is depressed Xlist will insert
  1036.       into the command line the above command.  The [x] position can either be
  1037.       blank, 'A' for Alt, 'S' for shift or 'C' for ctrl followed by the function key
  1038.       value from 1 through 10.
  1039.  
  1040.       Example:
  1041.  
  1042.       To invoke the F4 function key you would enter "/F4".
  1043.       To invoke the alternate F4 function key you would enter "/FA4".
  1044.  
  1045.  
  1046. /FIND    - FIND FILES ON CURRENT DRIVE
  1047.  
  1048.       The /FIND command will search the current drive locating all files that
  1049.       match the selection criteria specified with the /FIND command.  The
  1050.       results are displayed as if the files are all contained on the same
  1051.       drive/directory. To re-display the normal directory either press the ESC
  1052.       key or enter the /RD command.
  1053.  
  1054.       Examples:
  1055.  
  1056.       Find all batch files that start with either a "A" or "B".  The right and left
  1057.       bracket is used to specify optional characters in a specified location
  1058.       within the name.  The normal "*" and "?" wildcard characters can also be
  1059.       used.
  1060.  
  1061.       /FIND=[AB]*.BAT
  1062.       Find all files with the extension of WK1.
  1063.  
  1064.       /FIND=*.WK1
  1065.  
  1066.  
  1067. /LZH    - EXPAND AN "LZH" FILE DIRECTORY
  1068.  
  1069.       Same function as the /EXP command for archive files with the ".LZH"
  1070.       extension.  See the /EXP command for further details.
  1071.  
  1072.  
  1073. /MOVE   - MOVE FILE
  1074.  
  1075.       Use the MOVE command to move a file from one directory to another
  1076.       directory on the same drive.  This program uses a feature of the DOS
  1077.       RENAME function that will logically move a file from on directory to
  1078.       another.  This command will also change the name of the file during the
  1079.       move if you wish.
  1080.  
  1081.  
  1082. /O      - OMIT THE FILENAME & EXTENSION FROM COMMAND
  1083.  
  1084.       When the /O is found in the command line it is extracted from the command
  1085.       line and before the entered command is passed to the DOS command
  1086.       processor the screen is cleared.
  1087.  
  1088.       This command is used to keep Xlist from appending the filename and
  1089.       extension to the end of the command entered on the command line.  This
  1090.       can be useful when entering DOS commands from the command line, since in
  1091.       most cases the filename shouldn't follow the command.
  1092.  
  1093.  
  1094. /P      - PAUSE AFTER EXECUTING COMMAND
  1095.  
  1096.       When the /P is found in the command line it is extracted from the command
  1097.       line and before the entered command is passed to the DOS command
  1098.       processor the screen is cleared.
  1099.  
  1100.       The /P command is used to cause Xlist to pause after executing the
  1101.       command entered on the command line.  This can be used in conjunction
  1102.       with the /C command to allow the screen to be viewed before Xlist takes
  1103.       control and refreshes the screen. /RD     - RELOAD THE Xlist DIRECTORY AND RESET MASK
  1104.  
  1105.       The /RD command is used to reload the Xlist internal directory.  This can
  1106.       be used to refresh the current directory when modules are added or when
  1107.       directory clean-up is necessary.
  1108.  
  1109.       At this time a optional parameter can be entered resetting the mask used
  1110.       to select the entries to reload.
  1111.  
  1112.       Examples:
  1113.  
  1114.       Set Xlist to only load the files with an extension of "EXE":
  1115.  
  1116.       /RD=*.EXE
  1117.  
  1118.       Reload the directory with the default mask:
  1119.  
  1120.       /RD
  1121.  
  1122.  
  1123. /RESET  - RESET TO CURRENT DRIVE & DIRECTORY
  1124.  
  1125.  
  1126.       You may stack a series of commands that take you to another drive or
  1127.       directory.  When returning to Xlist from executing all commands, Xlist will
  1128.       sense the drive or directory change and reload the directory list.
  1129.       Normally, you what Xlist to execute in this fashion.  But, in special cases
  1130.       where you would like to stay in the current drive and directory then
  1131.       execute this as the last command to reset to the current drive and
  1132.       directory.
  1133.  
  1134.       Example:
  1135.  
  1136.       An example is provided extracting an entry from a LZH archive file to a
  1137.       temporary drive and directory, view the file and delete the file.  Without
  1138.       the /reset command Xlist would sense the drive/directory change and
  1139.       reload from the temporary drive.
  1140.  
  1141.       E:~LHA e $A $F~LIST $~ERASE $~/reset
  1142.  
  1143.       The command above would switch to the E: drive, extract the current LZH
  1144.       entry to the E: drive, view the entry with the LIST program, erase the file
  1145.       then return to the previous drive/directory. /RF     - RE-FRESH THE Xlist FUNCTION KEYS
  1146.  
  1147.       The /RF command is used to refresh the Xlist function definitions.  This
  1148.       is useful when the "Xlist.PRO" file is changed and you want the changes
  1149.       to take effect.
  1150.  
  1151.  
  1152. /S      - TOGGLE *OVERLAY OPTION ON or OFF
  1153.  
  1154.       The /S command is used when launching a application to toggle the use of
  1155. the *OVERLAY profile command on or off.  If the *OVERLAY profile command
  1156. is disabled, the use of /S will temporarily enable the option for this
  1157. execution of one application.
  1158.  
  1159.  
  1160. /Sx[-]  - SORTING DIRECTORY
  1161.  
  1162.       The following methods maybe used to sort the directory:
  1163.  
  1164.       /SA   Sort by file attribute
  1165.       /SE   Sort by extension
  1166.       /SB   Sort by filesize
  1167.       /SN   Sort by name
  1168.       /SD   Sort by file maintenance date
  1169.       /ST   Sort by extension, directories to top
  1170.  
  1171.       The command maybe optionally followed by a "-" to denote a reverse sort
  1172.       sequence.
  1173.  
  1174.  
  1175. /SET    - SET FUNCTION KEYS
  1176.  
  1177.       This command provides the user with a method of defining the function
  1178.       keys F1-F12 interactively while Xlist is currently executing.  This
  1179.       command follows the same rules under which the *PFKEYS profile command
  1180.       follow.
  1181.       The format for the command is as follows:
  1182.  
  1183.       /SET Xnn (btd) function
  1184.  
  1185.       X           = Shift key indicator
  1186.       blank       = unshifted
  1187.       S           = right or left shift depressed
  1188.       C           = CTRL depressed
  1189.       A           = ALT depressed
  1190.       nn          = Function key number (1 through 12)
  1191.       btd         = Abbreviation for display (optional)
  1192.       function    = Text of command line
  1193.  
  1194.  
  1195. /START  - START AN OS/2 SESSION (OS/2 ONLY)
  1196.  
  1197.       This command will allow you to start a new session using the capabilities
  1198.       of the DosStartSession OS/2 function.  The command will search the PATH
  1199.       when the full full qualified name is not provided.  If a ICON is located in
  1200.       the same path as the program with the extension of .ICO, it will be used as
  1201.       the ICON.  The syntax of the command is:
  1202.  
  1203.       /START [-TIT:title] [-NOC] [-BG] [-FS | -PM | -WIN] [-I] [-MIN | -MAX] {program
  1204.       name} [program arguments]
  1205.  
  1206.       Parameters:
  1207.  
  1208.       title       Specify the title to assign to the session which is displayed
  1209.                   on the Presentation Manager menu and session window.
  1210.  
  1211.       -NOC        Specify not to close the window when the program ends.
  1212.  
  1213.       -BG         Start the program in the background.
  1214.  
  1215.       -FS         Start the program as a full screen session. (NOTWINDOWCOMPAT)
  1216.  
  1217.       -PM         Start the program as a PM session. (WINDOWAPI)
  1218.  
  1219.       -WIN        Start the program as PM compatible. (WINDOWCOMPAT)
  1220.       -I          Pass current environment settings to the starting session.
  1221.  
  1222.       -MIN        Set window state as MINIMIZED.
  1223.  
  1224.       -MAX        Set window state as MAXIMIZED.
  1225.  
  1226.       -CMD        Invoke the program session using CMD.EXE.
  1227.  
  1228.       -K          Invoke the program session using CMD.EXE with the /k option
  1229.                   that keeps the session when terminated.
  1230.  
  1231.  
  1232. /TREE   - Xlist DIRECTORY STRUCTURE
  1233.  
  1234.       This command will load a graphic directory tree of the current drive.
  1235.       From within the directory tree, you can navigate to other
  1236.       sub-directories, create directories, and delete directories.
  1237.  
  1238.       To reload a directory tree use the /RTREE command.
  1239.  
  1240.  
  1241. /UD     - UPDATE DIRECTORY ENTRY WITH CURRENT DATE & TIME
  1242.  
  1243.       The /UD command is used to modify a directory entries date and time.  When
  1244.       the command is entered with no operands the corresponding directory
  1245.       entries date is set to the currently set DOS date and time.
  1246.  
  1247.       The /UD command can optionally be followed be either a date or a time
  1248.       which is recognize by Xlist by the dash for date and the colon for time.
  1249.       These separator characters are specified by MS-DOS using the COUNTRY
  1250.       command in CONFIG.SYS.
  1251.  
  1252.       Example:
  1253.  
  1254.       Set date to current date & time:          /UD
  1255.       Set date to July 2, 1985:                 /UD=07-2-85
  1256.       Set time to 12:00 noon:                   /UD=12:00:00
  1257.  
  1258. /V      - VERIFY ON ERASE or VERBOSE ON COPY
  1259.  
  1260.       When the /V is found in the command line it is extracted from the command
  1261.       line and before the entered command is passed to the DOS command
  1262.       processor the screen is cleared.
  1263.  
  1264.       The /V command in conjunction with the ERASE command will prompt the
  1265.       user to erase the file or not.  With the COPY command, Xlist will display
  1266.       the entry being copied.
  1267.  
  1268.  
  1269. /ZIP    - EXPAND AN "ZIP" FILE DIRECTORY
  1270.  
  1271.       Same function as the /EXP command for archive files with the ".ZIP"
  1272.       extension.  See the /EXP command for further details.
  1273.  
  1274.  
  1275. /ZOO    - EXPAND AN "ZOO" FILE DIRECTORY
  1276.  
  1277.       Same function as the /EXP command for archive files with the ".ZOO"
  1278.       extension.  See the /EXP command for further details.
  1279.  
  1280.  
  1281. /nnn    - DISPLAY DIRECTORY STARTING WITH nnn ENTRY
  1282.  
  1283.       The /nnn command is used to make Xlist display the current screen
  1284.       starting with the nth directory entry.  You can use the +- signs to
  1285.       position an offset from the current position.
  1286.  
  1287.       Examples:
  1288.  
  1289.       /80         Position to the 80th entry in the list.
  1290.       /+1         Position to next entry.
  1291.       /-1         Position to previous entry.
  1292.       /999        If the number is greater than the number of entries, Xlist
  1293.                   will position to the last entry.
  1294.       /1          Position to the 1st entry.
  1295.  
  1296.  
  1297. ?       - REDISPLAY LAST COMMAND ENTERED
  1298.  
  1299.       The ? command will cause Xlist to display the last command entered on the
  1300.       command line.
  1301.  
  1302. =       - REPEAT THE LAST COMMAND ENTERED
  1303.  
  1304.       The = command will cause Xlist to execute the last command entered for
  1305.       the directory entry adjacent to the command line where the = command is
  1306.       entered.
  1307.